LOADING INSTRUCTIONS FOR NOOBS (OZvm)
Zoggle for Cambridge Computer Z88 emulator(s)
=============================================

Adapted from a similar document by John Connolly for the 2020 CSSCGC
which also contained a Z88 entry by Jamie Bradbury. These instructions
are pretty much idiot-proof for even the noobiest of Z88 noobs.

For the record, I am using the "raw" Java version of OZvm v1.2, i.e. one that's
been compiled as a .jar file. This should be usable on any OS that has Java
installed. Navigate to it in a command prompt / terminal window (delete as
appropriate) and run it with:
java -jar z88.jar

NOTE for anyone familiar with Jamie Bradbury's previous Z88 entries - this time
it's been provided as a .BBC file, which is the what the Z88DK compiler will
spit out when compiling for BBC BASIC. The program can't be LISTed, but the
loading process is similar to what it was for BASIC listings contained in raw
.TXT files, just without the extra fannying around with *CLI to type out its
contents, character by character.

--------------------------------------------------------------------------------

To install and run 'Zoggle' from its .BBC file using OZvm v1.2:

1.	Click on an empty slot from 1 to 3 at the bottom of the emulator window. If
	no slots are available, you will have to remove one of the installed cards.
2.	The 'Create Card' window should open. Change the card type to anything but
	'RAM' ('EPROM' should do the trick), and then click on 'Load Files...'.
3.	Navigate to the folder where the BASIC listing is stored (that's
	'Zoggle1.bbc') and select the file. Make sure the box for 'Create File
	Area' is ticked.
4.	Select 'Yes', and the card should now appear installed in the Z88.
5.	Perform a hard reset of the Z88. (It's under the 'Z88' menu.)
6.	Use the cursor keys within the Z88 to navigate to the FlashStore
	application (or press ALT+J). Press ENTER to open it. Once loaded, move
	the flashing cursor to the card which you have just installed and press
	ENTER to inspect its contents.
7.	Once inside the card, 'Zoggle1.bbc' should be present in the directory.
	Select it and press ENTER (making sure your cursor is in the directory
	view).
8.	You will be asked if you want to copy 'Zoggle1.bbc' to the Z88's
	internal RAM (as 'RAM.0/Zoggle1.bbc'). Press ENTER to confirm.
9.	Now that the listing is in the Z88's RAM disk, press ESC until you return 
	to the application menu. Now, select BBC BASIC (or press Alt+B).
10.	Once inside BBC BASIC, type the following:
	LOAD ":RAM.0/ZOGGLE1.BBC"
	NOTE that the double-quote on OZvm is SHIFT+apostrophe, as it would be on
	a Mac or an American keyboard, not SHIFT+2, the way we're used to (and
	certainly not SYMBOL SHIFT+P).
	The program will load near-instantly. LIST will, strangely, only list the
	first line with no spaces anywhere...
11.	Eventually, the program will finish loading (for reference, the final line 
	number is 650, a DATA statement).
12.	Make a snapshot at this point to save going through the whole process 
	again. Select 'Save Z88 snapshot' from the 'File' menu and choose your
	filename. (NOTE that I've done all this already! 'Zoggle2.z88' should be
	right there waiting for you in the 'Jim's Additional Material' folder.
	Note that this is the bugfixed version! 'Zoggle1.z88' is the bugged
	version that I reviewed.)
13. To play the game, type 'RUN' and hit ENTER. Just like a Spectrum, or a ZX81,
	or even... gasp!... a BBC Micro!

These steps assume you are using a freshly installed version of OZvm
v1.2 for Windows. This guide has not been tested on other versions of
OZvm or different operating systems. No liability can be accepted for
damage to your computer or yourself as a result of following these
instructions (though I can't imagine how one would incur such damages).
